network object

This method is used to request events from the outside world.

network_event request()

Parameters:
None.

Return value:
Returns a network_event object containing all the information about the event received.

Remarks:
This method is used to poll the network for any events that are received from the outside, so that they can be properly handled by your application.

To access the data that the request method returns, simply access the properties of the network_event object as you would any other object properties. If no event was found or if an error occured, a network_event object with the type property set to event_none and all the other properties set to their default values is returned.

You must be sure to call this method continuously in your game as soon as you begin dealing with one or more remote peers. Failing to do so will cause the communication to lag.

Example:
See the main network chapter.